<head>
<title>FVT JCA Resource Adapter Tests</title>
</head>

<h1>FVT JCA Resource Adapter Tests</h1>

<body>
	FVT automated tests for JCA are launched from imaAutoJCA.sh. This
	script runs the following test buckets:
	<br />
	<ul>
		<li><a href="#setup">JCA Test Setup</a>
		<li><a href="#tests">JCA Test Groups</a>
			<ul>
				<li><a href="#Basic">JCA Basic Tests</a></li>
				<li><a href="#SSL">JCA SSL Tests</a></li>
				<li><a href="#Trans">JCA Local Transaction Tests</a></li>
				<li><a href="#BMT">JCA Bean-Managed Transaction Tests</a></li>
				<li><a href="#CMT">JCA Container-Managed Transaction Tests</a>
				</li>
				<li><a href="#XAError">JCA XA Transaction Error Tests</a></li>
				<li><a href="#Reconnect">JCA Reconnect Tests</a></li>
				<li><a href="#HA">JCA High Availability Tests</a></li>
			</ul>
		<li><a href="#cleanup">JCA Test Cleanup</a>
	</ul>
	<br />

	<div>
		<a id="setup"><h3>SETUP: ima-JCA-Setup-00.sh:</h3></a> This bucket
		does the following:<br />
		<ul>
			<li>Performs variable replacement in several files
				<ul>
					<li>test.config<br /> <code>M1_NAME</code> is replaced with <code>MQKEY</code>
						from ISMSetup.sh (marxxx)<br /> <code>A1_IPv4_1</code> is
						replaced with <code>A1_IPv4_1</code> from ISMSetup.sh (IP of
						MessageSight Appliance)<br /> <code>A2_IPv4_1</code> is replaced
						with <code>A2_IPv4_1</code> from ISMSetup.sh (IP of Second
						MessageSight Appliance - For HA)<br /> <br />
					</li>
					<li>tests.properties<br /> <code>M1_NAME</code> is replaced
						with <code>MQKEY</code> from ISMSetup.sh (marxxx)<br /> <code>APPSERVER</code>
						is replaced with <code>WAS | WLS | JBOSS </code> depending on what
						appserver we run against<br /> <br />
					</li>
				</ul>
			</li>
			<li>Create admin objects with run-cli.sh and
				jca_policy_config.cli
				<ul>
					<li>Creates endpoints with policies to allow all JMS
						connections on any queue or topic, and any shared subscription</li>
					<li>Creates SSL related objects using common/imaserver-crt.pem
						and common/imaserver-key.pem</li>
					<li>Creates all send and reply Queues used by the test
						application.</li>
				</ul> <br />
			</li>
			<li>Run JMS JNDI configuration
				<ul>
					<li>Creates the connection factories, queues and topics and
						stores them in JNDI on the LDAP server.</li>
				</ul> <br />
			</li>
			<li>Configure IMA Resource Adapter (was.sh prepare and setup)
				<ul>
					<li>SCP's *.ear, *.py, tests.properties and *.config files to
						/WAS/ on WebSphere Application Server host machine</li>
					<li>Runs wsadmin script was.py, which reads configuration from
						test.config</li>
					<li>If StandAlone server:<br /> - Creates J2C connection
						factories, topics and queues at the node scope<br /> - Creates
						the activation specifications pointing at the IBM MessageSight
						server at the node scope<br />
					</li>
					<li>If Cluster:<br /> - Creates connection factories, topics
						and queues at the cluster scope<br /> - Creates the activation
						specifications pointing at the IBM MessageSight server at the
						cluster scope<br />
					</li>
				</ul>
			</li>
			<li>Install test application (was.sh install)
				<ul>
					<li>Runs wsadmin script install_app.py, which reads
						configuration from test.config</li>
					<li>Installs the test application and starts it.<br />
					</li>
				</ul>
			</li>
		</ul>
	</div>

	<div>
		<a id="tests"><h3>JCA Test Groups</h3></a> The following test groups
		are run as part of the JCA automation bucket:<br />

		<div>
			<a id="Basic"><h3>JCA Basic Tests: ima-JCA-Basic-01.sh:</h3></a>
		</div>
		<div>
			<a id="SSL"><h3>JCA SSL Tests: ima-JCA-SSL-02.sh:</h3></a>
		</div>
		<div>
			<a id="Trans"><h3>JCA Local Transaction Tests:
					ima-JCA-LocalTrans-03.sh:</h3></a>
		</div>
		<div>
			<a id="BMT"><h3>JCA XA BMTUT Tests: ima-JCA-XA-BMTUT-04.sh:</h3></a>
		</div>
		<div>
			<a id="CMT"><h3>JCA XA CMT Tests: ima-JCA-XA-CMT-05.sh:</h3></a>
		</div>
		<div>
			<a id="XAError"><h3>JCA XA Error Tests:
					ima-JCA-XAError-06.sh:</h3></a>
		</div>
		<div>
			<a id="Reconnect"><h3>JCA Reconnect Tests:
					ima-JCA-Reconnect-07.sh:</h3></a>
		</div>
		<div>
			<a id="HA"><h3>JCA HA Tests: ima-JCA-HA-00.sh:</h3></a>
		</div>
	</div>

	<div>
		<a id="cleanup"><h3>CLEANUP: ima-JCA-Teardown-00.sh:</h3></a>
		<ul>
			<li>Cleanup WebSphere Application Server Configuration
				<ul>
					<li>Uninstall Application</li>
					<li>Delete Configuration</li>
				</ul>
			</li>
			<li>Delete all files that were deployed to the WebSphere
				Application Server host machine</li>

			<li>Run IBM MessageSight configuration cleanup
				<ul>
					<li>Delete MessageSight Admin Objects and Durable
						Subscriptions</li>
				</ul>
			</li>
		</ul>
	</div>
</body>